home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / games1 / avvy.zip / AVVY.DOC < prev    next >
Text File  |  1993-02-07  |  25KB  |  478 lines
  1. You're supposed to read this file first!
  2.  
  3.                        Thorsoft of Letchworth presents...
  4.                            DENARIUS AVARICIUS SEXTUS
  5.  
  6.                        (A Roman Graphical Adventure Game)
  7.  
  8.                                   version 1.5
  9.  
  10.                        by Mike, Mark and Thomas Thurman.
  11.  
  12.  
  13.      (Welcome to the shareware world's first (as far as we know) graphical
  14.         interactive adventure game about a Roman citizen with red hair.)
  15.  
  16.                                  The background
  17.                                  """"""""""""""
  18. Back in good old A.D. 79, there lived a patrician Roman named Avaricius (Avvy
  19. to his friends.) He was about 26 years old and about six foot three. He had
  20. married a woman named Arkata, which was a mistake he lived to regret- she
  21. never stopped nagging him. His few slaves were so lazy he hardly ever saw them,
  22. except for one named Crapulus, who was always at least inebriated, if not
  23. downright drunk- apart from reading Avvy's mail (amazing! he could read) and
  24. doing the washing-up, he preferred to spend his time with an amphora of wine
  25. down at the "Canis et Anas" (his local.) (*)
  26.  
  27. You'd think Avvy had problems enough. However, he also lived in a pleasant
  28. seaside resort you may have heard of, called Pompeii, and he was unaware
  29. that in a few hours' time he would be buried alive. Well, maybe. Perhaps,
  30. with the guidance of his guardian angel from the twentieth century (that's
  31. where you come in) he might escape both Arkata and the volcano. The date
  32. is... 24th August, A.D. 79.
  33.  
  34. (*) = note for non-British players: this is an English term, signifying a
  35. person's usual drinking establishment.
  36.  
  37.                               The aim of the game
  38.                               """""""""""""""""""
  39. To escape from Vesuvius (and Arkata.)
  40.  
  41.                                     The game
  42.                                     """"""""
  43. Use the cursor keys (on the right of the keyboard) to move him about.
  44. If you want him to walk diagonally, use the key in between the two you need
  45. (e.g. use PgUp to make him walk up and right.) Enhanced keyboard users should,
  46. of course, use the numeric keypad arrows rather than the other ones if they
  47. wish to take advantage of this feature. And don't forget to switch NumLock off
  48. (if it's on), else you'll just get a lot of numbers on the command line.
  49.  
  50. You may also use the mouse. See under "Say cheese..." for more information.
  51.  
  52.                                       Keys
  53.                                       """"
  54. (Not the sort that open doors. Keyboard keys.)
  55.  
  56. Suppose you want to open a door. (Some doors are already open, so you can
  57. just walk through them. Most doors at the bottom of the screen are like this,
  58. as are some others.) If the door is closed, type in "open door" (with no
  59. inverted commas around it, of course) and hit Enter. The game will respond
  60. "Okay!".
  61.  
  62. See that "Okay!" message? It came up in a scroll. These are just to let
  63. you know what's going on. To get rid of one, hit Enter (Esc also works, or
  64. the plus key.)
  65.  
  66. (Something else to note: to get a list of everything you're holding, you
  67. can type "inventory" (or "inv" for short) but it's much easier to press
  68. Ctrl-I (or even just Tab (for new users: Tab is that key with the two
  69. arrows on just above either Ctrl or Caps Lock. (It depends on your
  70. keyboard. (Brackets' revenge!)))))
  71.  
  72. If you really like choosing things from menus instead of typing commands,
  73. you may prefer the menu interface. This is brought up by pressing Esc, or
  74. the / key (like spreadsheets.) Choose an option using the up, down, Home and
  75. End keys. Hit Enter, or +, when you've got the right one. Use Esc to get rid
  76. of a menu. This doesn't actually replace the command interface, as you must
  77. use it to enter passwords, etc, and some puzzles are impossible to solve
  78. using the menu interface alone because that would be TOO EASY. (which you
  79. don't want, do you?!)
  80.  
  81. Also, f7 & f8 change the background colour. You can make the screen really
  82. abhorrent if you're into that kind of thing :-) , but the main use for these
  83. two keys will be if and when the CGA version comes out (it probably won't)
  84. because CGA monochrome can get VERY boring... f2 toggles (nice word, that)
  85. the sound on or off, so that you won't wake up your spouse or significant
  86. mother-in-law when you play Avvy in the small hours. (Ever wondered why
  87. they're called the small hours? They're all made up of minutes!) (Minute, get
  88. it? Small- Oh, never mind...!) :-)
  89.  
  90.                                  Say cheese...
  91.                                  """""""""""""
  92. How to use Avvy with a mouse: The left button is the same as Enter, the right
  93. is the same as Esc. Moving the mouse in any one of the eight directions is just
  94. like pressing that cursor key, so a light touch in that direction is ALL
  95. that's really needed. The mouse is ENTIRELY optional: you may use it if the
  96. driver's installed but you don't have to, and you may just use the cursor
  97. keys, etc., as normal.
  98.  
  99. You can see if the mouse is installed, because one of the scrolls at the start
  100. will be mouse information. Use the right key to enter the menu system (from the
  101. prompt), and when there use the left key to select and the right key to cancel.
  102. You may lose a scroll by clicking on either side (?!) and if you are asked a
  103. "yes/no" question, you can use the left key for yes and the right key for no.
  104.  
  105. If your mouse switches between 3-key and 2-key (MS compatible) mode, like ours 
  106. used to, leave it on the same setting throughout the game, or it will start 
  107. sending silly messages to the computer. This is actually true for quite a lot 
  108. of programs.
  109.  
  110.                                Saving and loading
  111.                                """"""""""""""""""
  112. Type "save" or "load". This is useful if you should get struck by lightning,
  113. or something- you can just reload. (Yes, you CAN get struck by lightning!)
  114. You will be asked to enter a filename. (Usually a good idea is to name it
  115. with your name plus a number (e.g. "MARVIN1". This will save a file called
  116. "MARVIN1.ASG" in the current directory.))
  117.  
  118. You will then be asked to describe your file. Don't say something stupid like
  119. "a game file"- that's obvious! Your comment will be saved in the file, and
  120. displayed when you reload the game, although you don't have to give a
  121. comment if you don't want to.
  122.  
  123. Typing in "DIR" will give a list of .ASG files in the current directory. 
  124. "DIR B:" will give all .ASG files on drive B:, etc.
  125.  
  126.                            Lion through your Teeth...
  127.                            """"""""""""""""""""""""""
  128. "Avaricius" contains an integrated shoot-'em-up. I know it's not exactly
  129. "Galaga", but never mind. The game should be self-explanatory. Please note
  130. that the keys are:
  131.  
  132.            "A" = Up
  133.            "Z" = Down
  134.        "Enter" = Fire
  135.  
  136. (You are bound to get eaten while playing this. Let's hope that the gods of
  137. Olympus are on your side. (Jupiter? No, she went of her own accord. (?)))
  138.  
  139. (This routine has now been polished up slightly, but a few inaccuracies remain
  140. here. Please note: you need to kill 7 or more lions to continue with the game. 
  141. (It's easy, there's a knack to it. When you've got the knack you can always 
  142. knock over lions, which goes to prove the old saying: Pride goeth before a 
  143. fall...)) 
  144.  
  145.                                  Brand loyalty
  146.                                  """""""""""""
  147. At the start of the game, on the loading screen, is the message: "Compliments
  148. of Thorsoft." This is known as a brand. It is embedded within the code. When
  149. you register, please specify 5 1/4" or 3 1/2" disk. We will then send you an
  150. up-to-date copy of "Avaricius", branded with your name, together with a review
  151. copy of another Thorsoft game (currently "Spellchick"). ALL THIS FOR ONLY 5
  152. QUID / 10 BUCKS REGISTRATION FEE!!!
  153.  
  154.                           Enviromental Considerations
  155.                           """""""""""""""""""""""""""
  156. This game is environmentally friendly. It doesn't damage the ozone layer, it
  157. has never in tests been shown to pollute the Irish Sea with radioactive
  158. substances, and it was NOT tested on animals (they don't like the jokes
  159. anyway.) Furthermore, 97% of the jokes used in this release were recycled.
  160.  
  161.                           The next game in the series
  162.                           """""""""""""""""""""""""""
  163. Would you like to know what happened to him when he DID get out? (assuming
  164. you managed it.) Well, so would we. We won't even THINK about starting
  165. coding the sequel until we get some registrants (e.g. you.) Whether you liked
  166. this one or not, you'll be pleased to hear that the next one will be (even)
  167. better. So will the graphics and ESPECIALLY the jokes. We will send a review
  168. copy of this, or our latest game, to all registrants.
  169.  
  170.                    Who borrowed all the giraffe's paperclips?
  171.                    """"""""""""""""""""""""""""""""""""""""""
  172. Just to check if you're still reading. I'm glad to see that you are.
  173. (What would be the point of me sitting here typing all this if you weren't?)
  174.  
  175.                                   File logging
  176.                                   """"""""""""
  177. If you want to remember your progress through Pompeii, work out where you
  178. went wrong, and so on, you can redirect output to a file thus:
  179.  
  180. Instead of:  avvy
  181. type:        avvy <SPACE> = <SPACE> filename.ext
  182. e.g.:        avvy = memo.txt
  183.  
  184. Of course, you can also redirect output to a DOS device: "avvy = prn" copies
  185. all the info to the printer on LPT1: (for parallel printers. If yours is
  186. serial, use "avvy = aux" instead.)
  187.  
  188. The only device you can't log to is "con", which is the screen. This would
  189. really muck up the screen display if you could (I tried it.) To see whether
  190. it is or not, a "\" is printed first, then checked to see if it's on the
  191. screen or not. If it is, the log file is terminated.
  192.  
  193. >Lines beginning with a prompt character are what you typed.
  194. "Lines beginning with an inverted comma are what the computer replied.
  195. (Bracketed lines are "stage directions"; e.g. "The game was restarted.")
  196.  
  197. (You may also use /q on the command line to hush Avvy up and prevent your
  198. boss's wrath from flaring up if she hears the strains of "The King of the
  199. Beoetians" floating across the office.)
  200.  
  201.                                   Shift-PrtSc
  202.                                   """""""""""
  203. There is a screen-dump routine built into Avvy. Press Shift-PrtSc to activate
  204. it. (Not on the "Back in good old..." or loading screens.) It unhooks itself
  205. from Int 5 when you leave the program. (Sorry if I'm confusing you...)
  206.  
  207. Use the option /n on the command line to stop the program hooking Int5. This
  208. is in case you own one of those super-whizzy EGA screen dump programs which
  209. are slightly less naff... sorry, more well-polished... than our built-in one.
  210. (Thanks to Mark, who designed the colour shading on the dump. Great.)
  211. The /n option is also useful if you haven't got an Epson-compatible and are
  212. using a special screen-dumping routine.
  213.  
  214. NB: Epson-compatible is as Epson-compatible does, as the old saying goes (I 
  215. think.) It works fine on our Panasonic KX-P1080. Whether it does on your Epson-
  216. compatible, or even on your Epson, is only discoverable by you, as clones vary 
  217. a lot. I should think it probably would, but you never know.
  218.  
  219.                                 For power users.
  220.                                 """"""""""""""""
  221. Some power users who have '286s or above may need to have the program slowed 
  222. down slightly for your computer's "brain the size of a planet"! Include on the 
  223. command line the word "/sxxx" (where xxx is any number you like) and then the 
  224. program will delay for xxx milliseconds every step (our Turbo manual says 
  225. they're milliseconds.) Those of you with the tortoise-compatible 4.77Mhz XT's 
  226. will have to grin and bear it, sorry. You don't actually have to use this
  227. command if you like it as it is, of course. 
  228.  
  229. If you prefer the game to run slightly more slowly, this command can also
  230. be useful. There is also a routine which slows the game down by reading the
  231. system clock, so it SHOULD run equally fast on most machines, but you never
  232. know...
  233.  
  234.                                  Avvy T-Shirts!
  235.                                  """"""""""""""
  236. This is (at the moment) just an idea. We know where we could get them from,
  237. but we want to know that our users have some support for the game. They
  238. would probably cost just over a fiver each plus p&p. (You never know, we
  239. might get some sweatshirts, baseball caps, etc, too if people want them.)
  240. Of course, this is ONLY for the registrants. Our advice to non-registrants
  241. is: register!
  242.  
  243.                               Your boss is coming!
  244.                               """"""""""""""""""""
  245. OK, you can look back to the screen now, I was only joking. But suppose he (or
  246. she) WAS coming? With Avvy you're prepared. Just hit ^B or alt-B and then Enter
  247. and you will get a nice graph showing spring sales for the first quarter.
  248. (There's an option on the menu that does this, too.) If you watch it,
  249. you'll see why it was for "spring"! Esc gets you out of this and back to your
  250. game when SWMBO (She Who Must Be Obeyed) has gone elsewhere. You may press
  251. any key to pause the graph, so it looks slightly more conventional.
  252.  
  253.                                 File extensions
  254.                                 """""""""""""""
  255. The following special filename extensions are used here (apart from .EXE,
  256. .DOC and .ME, which should be fairly obvious!).
  257.  
  258.      AVD = AVvy Data file. Nothing interesting to you here, only to the game.
  259.      TRP = "TRiPpancy". Also, uninteresting to you!
  260.      ASG = Avvy Saved Game (the saved positions)
  261.  and BGI = Borland Graphics Interface- needed for EGA.
  262.  
  263.                                 How was it done?
  264.                                 """"""""""""""""
  265. Good question. The pictures were almost all drawn by Mark Thurman, and the code
  266. was written by Thomas Thurman in Turbo Pascal 5.5, on an Opus PC IV Turbo with
  267. an AMS mouse. Mike Thurman bought Turbo (and the computer) in the first
  268. place. Thanks to Mike, Liz, Mandy and Andrew for support and suggestions of
  269. what we could do.
  270.  
  271. (If you see a dud picture it was probably drawn by me (Thomas). I'm no artist- I
  272. got kicked out of Art at school. Sorry. Next time a higher percentage of the
  273. pictures will be by Mark. (NB: Most of my pictures have now been tidied up
  274. by Mark, anyway.))
  275.  
  276. There was only ONE piece of assembler used in the coding, which was written
  277. by Kent Cedola. We found it on Shareware Marketing disk no.500, and the
  278. routine has the name of "Gpwtcol". It was one of a set used on TP 3.0 (which
  279. didn't support EGA) but the set includes one or two very neat routines that
  280. Borland didn't offer with Turbo Pascal. It was used to speed up the walking
  281. ("trippancy") routines. (You should have seen it before...!)
  282.  
  283. Right, back to the documentation... The finished .EXE file was compressed using
  284. the brilliant public-domain utility "LZEXE" by Fabrice Bellard. 
  285.  
  286. NB: Hands off the files. Anyone who is discovered to have mucked around with
  287. *ANY* of the Avvy files will have their registration terminated and we will
  288. NEVER EVER EVER let them re-register! So there. You have been WARNED.
  289.  
  290. Oh, yes... Virtually all of the places in this game actually existed in towns
  291. such as Pompeii, but not necessarily exactly as we've shown them or in that
  292. order. We tried to make it fairly historically accurate, but if you discover
  293. anything that doesn't fit, take it as surrealism... (halibuts wear 
  294. sunglasses...)
  295.  
  296.                                How about support?
  297.                                """"""""""""""""""
  298. Fine. You can 'phone us and ask about the game, or write to us, but you'll have
  299. to be registered- more info pending on registration!
  300.  
  301.                              "Register, or your..."
  302.                              """"""""""""""""""""""
  303. Several shareware programs give the following cheerful message at the end:
  304. "Register, or your conscience will haunt you for the rest of your life."
  305. We decided to cheer this up a bit, by making a few improvements!
  306.  
  307.                          What on earth is a "pedigree?"
  308.                          """"""""""""""""""""""""""""""
  309. Check the file PEDIGREE.DOC. This contains a list of names. The first one will
  310. be the name of a member of Thorsoft. This person will have given it to a friend
  311. or a bulletin board or a shareware library, etc., and this recipient will put
  312. their name down as no.2. Whoever gets it next will be no.3, and so on. This
  313. file doesn't have to be completed, but it's nice if you do (of course, you can
  314. use a nickname like "Cowboy" or "Mouse", or something). You should also add
  315. your rough geographical location (eg Letchworth, Tewkesbury, New York or
  316. whatever.) It's then possible to see where on earth (literally) that copy
  317. of the program's been.
  318.  
  319.                                 Revision history
  320.                                 """"""""""""""""
  321. ver.no.   date      comments
  322.  
  323. 1.50    Mar 1992  One or two bugs fixed: firstly, the lions now have to get
  324.                    closer to kill you than before, and secondly, Gedalodava's
  325.                    legs no longer get left behind at a certain part of the
  326.                    game (can't tell you where, it would give away clues!)
  327.                    Also you fall down the crack when you reach it,
  328.                    not about six feet beforehand, like in previous versions!
  329.                    One or two titchy other ones eliminated, too. Oh, yes,
  330.                    saying "hello" no longer gets you struck by lightning...
  331.  
  332. 1.40    Jan 1992  Various shoot-'em-up bugs fixed, also another interesting
  333.                    little one- did you know that in 1.30 & below if you
  334.                    walked where Didymus was he reappeared? Also, in previous
  335.                    versions only registrants were allowed to win. In the
  336.                    interests of goodwill and the shareware ethic, this
  337.                    "feature" has now been permenantly disabled. See below.
  338.                    Plus, the bug that has plagued us since almost the
  339.                    beginning has been fixed! Gedalodava no longer leaves
  340.                    shadows on the screen. (Would you believe, just one
  341.                    variable was wrong? I set it to False, and hey presto! it
  342.                    worked.) Oh yes, the three versions prior to 1.40 claimed
  343.                    to be v1.10 in the saved files. A flash of lightning has
  344.                    been added on MOAG PLC's report, also a proper keyboard
  345.                    sink, and the writing effect has been speeded up. "Talk to
  346.                    him" now works everywhere, even with Didymus (it didn't
  347.                    before.) Also, for some reason all previous versions gave
  348.                    the menu option "talk to Gedalodava" in the harbour. That's
  349.                    now fixed. Anything else...?
  350.  
  351. 1.30    Dec 1991  Three Little Bugs sorted out- if you left your house, turned
  352.                    round and then walked straight back in again, you hung
  353.                    the computer up! This is now fixed, of course. Also a
  354.                    small error with the wall outside the Treasurer's house,
  355.                    and a bug where if you DIR'd a non-existent drive it
  356.                    caused a run-time error.
  357.  
  358. 1.20    Oct 1991  Fixed an annoying bug which hung the game up if you went
  359.                    anywhere near the amphitheatre! (Thanks to Ken Hughes
  360.                    for pointing this out.) Also one or two minor ones.
  361.  
  362. 1.10    Sep 1991  Cleared up minor bugs: incorrect version no. on title
  363.                    scroll, slight error on Sinistrus's walking, one joke
  364.                    changed, proper branding routines implemented, and
  365.                    one or two other slightly annoying, very minor, bugs.
  366.  
  367. 1.00    Aug 1991  First ever...
  368.  
  369. This is version 1.50/E/E. (The first E stands for EGA. The second stands for
  370. English (we might do a Latin version. Who knows?))
  371.  
  372. OK, OK, we said that 1.30 was vitually bug-free. There is probably some wise
  373. maxim to cover what happened- about twenty bugs turned up two or three days
  374. after release! (Yes, I am exaggerating.) I just hope less bugs turn up in
  375. Spellchick- at the time of writing none are known in the current version.
  376. After all, the main Avvy program has over 5,000 lines of code, so there are
  377. bound to be bugs. (I heard the other day that some Microsoft products have
  378. over 500,000 lines- phew! Pity the valiant souls who have to debug that
  379. lot!)
  380.  
  381. In the interests of goodwill to all men, and all that, we have commented out
  382. the lines that let only registrants win (from v1.4 onwards). Henceforth,
  383. anyone can. ("Spellchick" has never had this restriction.) If you are playing
  384. an older version, for some reason, firstly give whoever it is a copy of this
  385. version, and secondly type the following:
  386.  
  387.    REGISTER <return> <lose scroll>
  388.    THIS VALIANT BAND THIS CHOSEN FEW <return> <lose scroll>
  389.    REGISTER <return> <lose scroll>
  390.  
  391. And the computer will say "Thanks a lot for registering!" Without this, YOU
  392. CANNOT WIN. The soothsayer won't let you. We have told him to relax his
  393. vigilance.
  394.  
  395. If you know of any bugs in the current release, please tell us. Then you can
  396. get it out of your system, and we can get it out of ours. (old joke...)
  397.  
  398.                                    Trademarks
  399.                                    """"""""""
  400. Some of the words used in this document are trademarks or registered
  401. trademarks of their respective owners (who else?). Just so you'd know...
  402.  
  403.                                    Cast List
  404.                                    """""""""
  405. Denarius Avaricius Sextus : our hero
  406. Arkata                    : his wife
  407. Crapulus                  : his slave
  408. Gaius Lupus Malus         : a rival of Avvy's
  409. Compactus Discus Romulus  : an old friend of Avvy's in the army
  410. Titus Nervus Pecunia      : a worried official
  411. Gedalodava                : a very beautiful slave girl!
  412. Sinistrus                 : a left-handed barman
  413. Julius Selfimportantius
  414.     Noxius                : a big-headed guard
  415. Didymus Tonitrusdeus
  416.     Hicesse               : someone who got on the wrong side of Lupus
  417. Gaius Quicphingus
  418.     Haruspicis            : a sly soothsayer
  419.  
  420.             AND... a star guest appearance from an Olympian god...
  421.                                (plus his guest)
  422.  
  423.                                  Press Reviews
  424.                                  """""""""""""
  425. (If we add anything to this section, it is not counted as a version change.)
  426.  
  427. "...You may even be treated to a few corny but amusing jokes! The best part
  428. of the game has to be the droll conversation between Avvy and his friends.
  429. Searching the screens for clues and trying out the various commands is also
  430. good fun. I did, however, find it very difficult, when fighting the lions,
  431. to control my side of the battle... perhaps you'll do better. ...I would
  432. recommend it as an addition to your library."
  433.                                  PC Shareware Magazine, February 1992, p.42.
  434.  
  435. "Brothers Thomas and Mark Thurman have had a hard year's work... Avvy, the
  436. game's hero, is in pursuit of his ultimate goal... He is impeded by the
  437. power of the taxman and the temptations of the vine, but if, in helping him
  438. in his quest, you lose the ultimate battle and die, you go to heaven and have
  439. your life evaluated by the gods!!"
  440.                                   HiFiW3, January 24th 1992, No. 735
  441.  
  442.  
  443.                             **** Registration! ****
  444.                                  """""""""""""
  445. This is NOT free software. We decided to distribute it as shareware because
  446. we believe we can trust you. If you don't register we have no incentive to
  447. continue writing games. (Even if you don't like them, we must get better!) Go
  448. on, restore our confidence in you. This game costs 8 pounds sterling, or 15 US
  449. dollars (posting to the USA is expensive, you know!) You must have bought more
  450. expensive software than that! Our address is:
  451.  
  452.            Thorsoft,
  453.              71, Baldock Road,
  454.                Letchworth,
  455.                  Herts SG6 3JP,
  456.                    Great Britain.
  457.  
  458. Make cheques payable to L.V. Thurman. Thanks!
  459.  
  460. Site licences are £10 sterling plus 50p per computer (or US$20 plus US$1 per
  461. computer), should you need a site licence. Certain nameless companies in the
  462. City of London have, I hear, been using alleged copies of a certain nameless
  463. game that may, at first sight, bear a vague resemblance to Avvy. Well, now's
  464. your chance to get a LEGAL clone.
  465.  
  466. If you want to contact us, you can e-mail us on:
  467.                Ebby: SEND your message to Thomas Thurman.
  468.          CompuServe: send to Mike Thurman, number 100021,3441.
  469.   Dr.Solomon's Fido: send to Thomas Thurman.
  470.  
  471. (In case your printer doesn't support it, this sign, £, is the pound sign.)
  472.  
  473. (This game comes to you from Letchworth, the Land of the Black Squirrels, the
  474. First Garden City- a town where there's only one street!)
  475.  
  476. Io!
  477.  
  478.